home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbevn25.zip / PCBEVENT.DOC < prev    next >
Text File  |  1992-06-24  |  34KB  |  811 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.         ╓───────────────────────────────────────────────────────────╖
  9.         ║              Welcome to PCBEvent Version 2.5.             ║
  10.         ║           The Ultimate In PCBoard Event Managers          ║
  11.         ║            Copyright (C) 1992 By David D. Casto           ║
  12.         ║                   All Rights Reserved                     ║
  13.         ║                                                           ║
  14.         ║                 6196  Deewood Loop East                   ║
  15.         ║                  Columbus, Ohio  43229                    ║
  16.         ║                         Voice                             ║
  17.         ║                     (614)  882-0994                       ║
  18.         ║                                                           ║
  19.         ╙───────────────────────────────────────────────────────────╜
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - II
  29. -----------------------------------------------------------------------------
  30.  
  31.  
  32.  
  33.  
  34.   Table Of Contents:
  35.   =================
  36.  
  37.  
  38.  
  39.  
  40.  
  41.         Cover Page ..........................................  I
  42.  
  43.         Table Of Contents ................................... II
  44.  
  45.         Legal Information ...................................  1
  46.  
  47.         Registration ........................................  2
  48.  
  49.         Program Features ....................................  3
  50.  
  51.         Upgrading ...........................................  3
  52.  
  53.         Installation ........................................  4-7
  54.  
  55.         Example PCBEvent.dat ................................  5
  56.  
  57.         Environment Settings ................................  6
  58.  
  59.         Batch Updating ......................................  7
  60.  
  61.         Example Board Bat ...................................  7-8
  62.  
  63.         Command Line Operation ..............................  9-10
  64.  
  65.         Once A Month Event ..................................  11-13
  66.  
  67.         Menu Selections .....................................  13
  68.  
  69.         Files Created And Modified By PCBEvent ..............  14
  70.  
  71.         Comments ............................................  15
  72.  
  73.         What's New ..........................................  16
  74.  
  75.         Files Included With PCBEvent v2.5 ...................  19
  76.  
  77.  
  78.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 1
  79. -----------------------------------------------------------------------------
  80.  
  81.                          PCBEvent Version 2.5
  82.                   The Ultimate In PCBoard Event Managers
  83.                     * A PCBoard 14.5a Event Utility *
  84.                    Copyright (C) 1992 by David D. Casto
  85.                         6196  Deewood Loop East
  86.                          Columbus, Ohio 43229
  87.                                 Voice
  88.                             (614) 882-0994
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  WARNING!!
  95.  =======
  96.  
  97.       As with all new software it is * strongly * recommended that you have a 
  98.       recent backup just in case.
  99.  
  100.  
  101.  
  102.  LEGAL:
  103.  =====
  104.  
  105.         David Casto hereby disclaims all warranties relating to this
  106.      software, whether express or implied, including without limitation any
  107.      implied warranties of merchantability or fitness for a particular
  108.      purpose. David Casto will not be liable for any special, incidental,
  109.      consequential, indirect or similar damages due to loss of data or any
  110.      other reason, even if David Casto or an agent of David Casto has been
  111.      advised of the possibility of such damages.  In no event shall David
  112.      Casto liability for any damages ever exceed the price paid for the
  113.      license to use software, regardless of the form of the claim.  The
  114.      person using the software bears all risk as to the quality and
  115.      performance of the software.
  116.  
  117.       You are free to distribute this software as long as there are no
  118.      modifications to any files in this archive, and the archive has a ZIP AV
  119.      from Bulletin Board Systems.
  120.  
  121.  
  122.  
  123.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 2
  124. -----------------------------------------------------------------------------
  125.  
  126.  REGISTRATION:
  127.  ============
  128.  
  129.       You may try PCBEvent for 30 days and if you find PCBEvent easy, and
  130.      convenient to use, a registration of $20.00 would be appreciated.  If
  131.      you do not like this software enough to register it then delete it!
  132.  
  133.       Registration includes:
  134.  
  135.  
  136.        1) New updates to the software available for download from Blue
  137.           Light BBS.
  138.  
  139.        2) User support also available on Blue Light BBS.
  140.  
  141.        3) A Registered Key file that removes "Registered to UNREGISTERED" to
  142.           "Registered to Your BBS.  All UNREGISTERED begging etc. will be
  143.           bypassed with the key file.
  144.  
  145.        5) As an added protection to event times, I have added another FREE
  146.           utility available to REGISTERED users.  LockDoor will lock a door
  147.           XX minuets before an event.  LockDoor is included with this archive
  148.           but will _NOT_ run without a Registered PCBEvent.key.
  149.  
  150.        6) Optional Author upload of the key file to your BBS.  (U.S. and
  151.           Canada only)
  152.  
  153.        7) Your peace of mind knowing that you have done the right thing!
  154.  
  155.    *********************************************************************
  156.    Key files are downloaded from Blue Light BBS or uploaded to your BBS!
  157.    *********************************************************************
  158.  
  159.                Blue Light BBS is located in Columbus, Ohio
  160.                       (614) 766-9708 14400 BPS
  161.                       (614) 766-9709 19200 BPS
  162.  
  163.   * Note:  Please address all correspondence to David Casto when calling
  164.            Blue Light BBS.
  165.  
  166.  
  167.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 3
  168. -----------------------------------------------------------------------------
  169.  
  170.  PCBEvent FEATURES:
  171.  =================
  172.  
  173.       Imagine an event manager that can check all your nodes to be sure that
  174.    all events will be ready to run at their scheduled times.  PCBEvent can
  175.    even do this from your Autoexec.bat!  If a node's event time is off it
  176.    will change it in a flash.
  177.  
  178.       PCBEvent is like most other event managers but has a lot of needed
  179.    extras that the others do not have.  Here is a list of some of the
  180.    features of PCBEvent.
  181.  
  182.   Built in Event Editor
  183.   Easy to set up and use
  184.   Built in Mouse support
  185.   Makes it's own EVENT.SYS
  186.   Unlimited events per day
  187.   A per node event status display
  188.   Easy to use data entry input fields
  189.   Menu interface for routine maintenance
  190.   Screen Burn Protection built into the Menu
  191.   Eight command line options for batch file operation
  192.   Monthly event option to allow for monthly maintenance
  193.   Checks the system clock and selects the next logical event
  194.   Day selection so you can run an event on the day(s) you want
  195.   Has it's own "WAIT" features that will hold your node(s) down
  196.   Option to stamp your Caller(x) log with the event start/end times
  197.   Intelligent enough to recognize a first time install and helps you get
  198.    through the process
  199.  
  200.       A demo key is included with PCBEvent 2.5. This demo key will allow you
  201.    to use the software as if it were registered.  The key will work for 30
  202.    days from the date PCBEvent was compiled.
  203.  
  204.  UPGRADING:
  205.  =========
  206.  
  207.       Please read PCBEvent.new BEFORE upgrading to a to this version.
  208.  
  209.  
  210.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 4
  211. -----------------------------------------------------------------------------
  212.  
  213.  INSTALLATION:
  214.  ============
  215.  
  216.         Make a directory PCBEvent, place PCBEvent.exe, PCBEvent.key and
  217.    PCBEAU.exe in this directory.
  218.    *********************************************************************
  219.    * Now Type "PCBEAU" to set the PCBEvent.exe attribute to Read Only. *
  220.    *********************************************************************
  221.    Next type "PCBEvent" and press ENTER.  Select option number 1, the set up
  222.    for PCBEvent.  The first thing it wants to know is how many nodes that you
  223.    want to set up.  It will then  ask you 8 things for each node:
  224.  
  225.    1) Path to Node x PCBoard.dat.
  226.    2) Event time.
  227.    3) What days to run the event. Place an X in FIRST space for it to run on
  228.       Monday, the SECOND space for Tuesday etc.
  229.    4) Slide Event if user is On-Line?
  230.    5) Minutes prior to suspend activity
  231.    6) Disallow uploads prior to event? (Y/N)
  232.    7) Minutes prior to event to disallow uploads.
  233.    8) First event batch file Path\FileName.  Must not be event.bat as this
  234.       is created by PCBoard.
  235.  
  236.       Press F10 to save this information.  You are done with this node.
  237.    Continue until all nodes are done.  (For explanations to the above
  238.    questions please see your PCBoard Manual. * No two nodes can run the same
  239.    batch file at the same time.
  240.  
  241.       Now select option 2, Node Event Editor.  Select a node number to 
  242.    Add/Edit event times.  Select one of the six boxes across the bottom of
  243.    the screen.  [Next] will display the next event in PCBEvent.dat.  [Prev]
  244.    will select the previous event in PCBEvent.dat.  [Edit] will allow you to
  245.    edit the event displayed on the screen.  [Add] will allow you to add an
  246.    event to PCBEvent.dat.  [Del] will allow you to delete the event displayed
  247.    on the screen. [Quit] will return you to the Main menu.
  248.    
  249.    You may have as many events as you like in the PCBEvent.dat.  There will
  250.    be a PCBEvent.dat in each node(s) directory.  If you would like, you may
  251.    edit these files with a text editor.
  252.  
  253.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 5
  254. -----------------------------------------------------------------------------
  255.  
  256.    PCBEvent.dat FORMAT:
  257.    ===================
  258.  
  259.          Line 1      Number of events
  260.          Line 2      First event time
  261.          Line 3      Days to run this event.  (MON thru SUN)
  262.          Line 4      Suspend time in min. (01-59)
  263.          Line 5      Slide event. (Y/N)
  264.          Line 6      Disallow uploads. (Y/N)
  265.          Line 7      Disallow uploads min. (01-59)
  266.          Line 8      First Path\FileName.bat of event.bat to run
  267.          Line 9      Second event time
  268.          Line 10     Days to run this event.  (MON thru SUN)
  269.          Line 11     Suspend time in min. (01-59)
  270.          Line 12     Slide event. (Y/N)
  271.          Line 13     Disallow uploads. (Y/N)
  272.          Line 14     Disallow uploads min. (01-59)
  273.          Line 15     Second Path\FileName.bat of event.bat to run
  274.          etc....
  275.  
  276.       Example PCBEvent.dat:
  277.       --------------------
  278.                 3                       <--- Number of events
  279.                 01:00                   <--- Event time
  280.                 XX XXXX                 <--- Will not run on Wed
  281.                 01                      <--- Suspend time min.
  282.                 Y                       <--- Slide event (Y/N)
  283.                 Y                       <--- Disallow uploads (Y/N)
  284.                 20                      <--- Disallow uploads min.
  285.                 C:\PCB\EVENT1.BAT       <--- Event batch to run
  286.                 02:00                   <--- Event time
  287.                 XXXX XX                 <--- Will not run on Fri
  288.                 12                      <--- Suspend time min.
  289.                 N                       <--- Slide event (Y/N)
  290.                 Y                       <--- Disallow uploads (Y/N)
  291.                 22                      <--- Disallow uploads min.
  292.                 C:\PCB\EVENT2.BAT       <--- Event batch to run
  293.                 03:00                   <--- Event time
  294.                 X XXXXX                 <--- Will not run on Tue
  295.                 13                      <--- Suspend time min.
  296.                 Y                       <--- Slide event (Y/N)
  297.                 Y                       <--- Disallow uploads (Y/N)
  298.                 23                      <--- Disallow uploads min.
  299.                 C:\PCB\EVENT3.BAT       <--- Event batch to run
  300.  
  301.  
  302.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 6
  303. -----------------------------------------------------------------------------
  304.  
  305.         After you have all nodes set up and all the PCBEvent.dat files done
  306.    select option 3 from the menu.  This is where all the action is.  PCBEvent
  307.    will read all dat files, sort, re-write them, read in PCBoard.dat and
  308.    adjust the next event time to the next logical event time, and even write
  309.    the event.sys file for your event(s).
  310.  
  311.     * See the "Once A Month" section for Once A Month events. *
  312.  
  313.    **************************************************************************
  314.         Note:  PCBEvent will set the event active field to "Y" unless there
  315.    is not an event in the PCBEvent.dat that is in the next 24 hour time
  316.    frame.  This will allow you to not run any events on any day(s).  PCBEvent
  317.    will stamp the Caller(x) log and PCBEvent.log if it sets the event active
  318.    field to "N" informing the sysop that no event(s) will run on this node
  319.    for the next 24 hours.
  320.    **************************************************************************
  321.  
  322.    ENVIRONMENT SETTINGS:
  323.    ====================
  324.  
  325.         PCBEvent can be executed from ANY directory if you make the following 
  326.    changes to your Autoexec.bat and reboot your system. This will omit the 
  327.    need to Change Directory to the PCBEvent directory before executing 
  328.    PCBEvent.
  329.  
  330.         Edit your Autoexec.bat and add this line.
  331.  
  332.                 SET PCBEvent=E:\PCBEvent
  333.  
  334.         Add the PCBEvent directory to your DOS Path statement in your
  335.    Autoexec.bat.
  336.  
  337.             Example Path Statement:
  338.             ----------------------
  339.               Path=C:\;C:\DOS;C:\UTIL;E:\PCBEvent
  340.  
  341.  
  342.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 7
  343. -----------------------------------------------------------------------------
  344.  
  345.    BATCH UPDATING:
  346.    ===============
  347.  
  348.         Edit your Board.bat and add this line.
  349.     
  350.     pcbevent /Nx              <--- Adjust node x event time
  351.  
  352.         Place this line in each Node(s) board.bat * before * executing
  353.    PCBoard. (Replace x with the Node Number).  Example 1 should be used if 
  354.    the sysop wants PCBEvent to run several times a day.  In this example 
  355.    PCBEvent will run each time a NON Shelled door is executed and after each 
  356.    drop to DOS.  On busy systems I recommend Example 2.  If you have had past 
  357.    problems with lock up's then you should use Example 1.
  358.  
  359.      EXAMPLE 1 BOARD.BAT (for Node 1):
  360.      --------------------------------
  361.  
  362.         @echo off
  363.         c:
  364.         cd\pcb
  365.         SET NODE=1
  366.         SET PCB=/SWAP/MAIN/RESET/BYTECRED:2/UPCRED:2
  367.         if exist remote.bat rename remote.bat remote.sys
  368.         if exist event.bat rename event.bat event.sys
  369.         if exist door.bat del door.bat
  370.         if exist endpcb del endpcb
  371.         pcbevent /N1
  372.         PCB145
  373.         if exist remote.bat remote
  374.         if exist door.bat door
  375.         if exist event.bat event
  376.         if exist endpcb goto end
  377.         board
  378.         :END
  379.  
  380.  
  381.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 8
  382. -----------------------------------------------------------------------------
  383.  
  384.      EXAMPLE 2 BOARD.BAT (for Node 1):
  385.      --------------------------------
  386.  
  387.         @echo off
  388.         c:
  389.         cd\pcb
  390.         SET NODE=1
  391.         SET PCB=/SWAP/MAIN/RESET/BYTECRED:2/UPCRED:2
  392.         if exist remote.bat rename remote.bat remote.sys
  393.         if exist event.bat pcbevent /N1   <---- Run PCBEvent here
  394.         if exist event.bat del event.bat  <---- Delete Event.bat
  395.         if exist door.bat del door.bat
  396.         if exist endpcb del endpcb
  397.         PCB145
  398.         if exist remote.bat remote
  399.         if exist door.bat door
  400.         if exist event.bat event
  401.         if exist endpcb goto end
  402.         board
  403.         :END
  404.    *************************************************************************
  405.         Notice that you _MUST_ delete event.bat.  Since PCBEvent makes a new
  406.     Event.sys DOS will _not_ allow you to rename it.  If you do not delete it
  407.     each time your board.bat cycles it will run your event and could cause
  408.     you a lock up!
  409.    *************************************************************************
  410.  
  411.  
  412.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 9
  413. -----------------------------------------------------------------------------
  414.  
  415.  COMMAND LINE OPERATION:
  416.  ======================
  417.  
  418.         There are 6 command line switches for use in batch files.
  419.  
  420.  
  421.         1) PCBEvent /N1
  422.  
  423.            PCBEvent will check, sort and write all of Node 1 files to be sure
  424.            the next event will execute when scheduled.  Use in your
  425.            Board.bat.  _DO NOT_ Use in your daily events, as it will remove
  426.            your event.bat causing your Node not to re-load.
  427.  
  428.         2) PCBEvent /R
  429.  
  430.            PCBEvent will check, sort and write ALL Nodes files to be sure the
  431.            next event will execute when scheduled.  _DO NOT_ Use in your 
  432.            daily events, as it will remove your event.bat causing your Node 
  433.            not to re-load.
  434.  
  435.         3) PCBEvent /START:1
  436.  
  437.            PCBEvent will stamp the NODE caller logs with the time the event
  438.            started.
  439.  
  440.         4) PCBEvent /END:1
  441.  
  442.            PCBEvent will stamp the NODE caller logs with the time the event
  443.            ended.
  444.  
  445.         5) PCBEvent /WaitUp:1:500
  446.  
  447.            PCBEvent will wait 500 seconds for Node 1 to return to the board.  
  448.            If PCBEvent waits for 500 seconds an errorlevel of 10 is returned.  
  449.            If node 1 returns to the board before the 500 seconds PCBEvent 
  450.            will return an errorlevel of 0.  Seconds may be as high as 999999.  
  451.            (See example EVENT1.BAT for usage/purpose of the errorlevel)
  452.  
  453.         6) PCBEvent /WaitDown:1:500
  454.  
  455.            PCBEvent will wait 500 seconds for Node 1 to drop to the Event.
  456.            If PCBEvent waits for 500 seconds an errorlevel of 10 is returned.
  457.            If node 1 drops to the event before the 500 seconds PCBEvent will
  458.            return an errorlevel of 0.  Seconds may be as high as 999999.
  459.            (See example EVENT1.BAT for usage/purpose of the errorlevel)
  460.  
  461.         7) PCBEvent /WaitDownWS:1:2:500
  462.  
  463.            This option is for systems that are running a LAN and have the
  464.            PCBoard node directories on workstations and PCBEvent on the
  465.            server.  This option _must_ be used with WaitUpWS.  The SET
  466.            PCBEVENT environment path must be available to each workstation.
  467.            Node 1 will wait for node 2 to exit PCBoard and run it's event.
  468.            It will wait 500 seconds before it will exit.  If node 2 has
  469.            dropped to the event before the 500 seconds an errorlevel of 0
  470.            will be returned.  If node 2 does not drop within the xxx seconds
  471.            an errorlevel of 10 will be returned.  Seconds may be as high as
  472.            999999.  See example Event2.bat.
  473.  
  474.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 10
  475. -----------------------------------------------------------------------------
  476.  
  477.  
  478.         8) PCBEvent /WaitUpWS:1:2:500
  479.  
  480.            This option is for systems that are running a LAN and have the 
  481.            PCBoard node directories on workstations and PCBEvent on the 
  482.            server.  This option _must_ be used with WaitDownWS.  The SET 
  483.            PCBEVENT environment path must be available to each workstation.  
  484.            Node 1 will wait for node 2 to return to PCBoard.  It will wait 
  485.            500 seconds before it will exit.  If node 2 has returned to 
  486.            PCBoard before the 500 seconds an errorlevel of 0 will be 
  487.            returned.  If node 2 does not return to PCBoard within the 500 
  488.            seconds an errorlevel of 10 will be returned.  Seconds may be as 
  489.            high as 999999.  See example Event2.bat.
  490.  
  491.         *********************************************************************
  492.         NOTE:  The counter on the WAIT features will have different MAX Time
  493.         each time you run them.  This is normal and is not a bug in PCBEvent.
  494.         *********************************************************************
  495.  
  496.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 11
  497. -----------------------------------------------------------------------------
  498.  
  499.  ONCE A MONTH EVENT:
  500.  ==================
  501.  
  502.         PCBEvent can run a "Once A Month" event.  This is for those of you
  503.       that need to have a special event that does things like Zip the log
  504.       files and start fresh for the new month, Pack the User file (Kill the
  505.       Users) etc.
  506.  
  507.         PCBEvent will look for a file named PCBEvent.mth in the "SET
  508.       PCBEVENT" path/current path.  If this file exists PCBEvent will analyze
  509.       it's content while processing all events.
  510.  
  511.         Here is a little information to help you understand how this feature
  512.       works.  With the following you should be able to set up a "Once A
  513.       Month" event.  I might add - with a little batch file creativity you
  514.       could have a "Once A Month" event several times a month.
  515.  
  516.  
  517.     HOW:
  518.     ---
  519.  
  520.         This event is a _replacement_ of a normal event not just another 
  521.       event.  You _must_ have a regular event scheduled and the day flags 
  522.       _must_ be set.  If the NODE field of the PCBEvent.mth file does not 
  523.       equal the NODE number then PCBEvent will continue with the normal event 
  524.       processing.  If the NODE field of the PCBEvent.mth file equals the NODE 
  525.       number being processed then PCBEvent will continue to analyze the "Once 
  526.       A Month" event data.
  527.  
  528.         If the DAY field of the PCBEvent.mth file equals today's DAY _AND_
  529.       the Time field of the PCBEvent.mth file equals the Next regular event
  530.       Time the Batch field in the PCBEvent.mth file will be substituted in
  531.       place of the Regular event Batch.
  532.  
  533.  
  534.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 12
  535. -----------------------------------------------------------------------------
  536.  
  537.     RULES:
  538.     -----
  539.  
  540.         1) The TIME field in the PCBEvent.dat file _MUST_ match the TIME
  541.            field in the PCBEvent.mth file.
  542.  
  543.         2) The DAYS event field in the PCBEvent.dat file _MUST_ have a flag
  544.            (X) for the DAY.
  545.  
  546.            Example:
  547.  
  548.   PCBEvent.mth> 1                   <- NODE To Run Event
  549.                 01                  <- DAY To Run
  550.                 00:02               <- TIME To Run
  551.                 05                  <- Suspend time
  552.                 N                   <- Slide event (Y/N)
  553.                 Y                   <- Disallow Uploads Prior
  554.                 10                  <- Disallow Uploads Time
  555.                 c:\pcb\Monthly.bat  <- Batch File To Run
  556.  
  557.  
  558.   PCBEvent.dat> 1                   <- Number Of Events
  559.                 00:02               <- TIME To Run
  560.                 XXXXXXX             <- DAYS Of The WEEK To Run (Mon-Sun)
  561.                 05                  <- Suspend time
  562.                 N                   <- Slide event (Yes/No)
  563.                 Y                   <- Disallow Uploads Prior
  564.                 10                  <- Disallow Uploads Time
  565.                 C:\PCB\EVENT1.BAT   <- Batch File To Run
  566.  
  567.  
  568.            Note that the TIME fields in both examples match.  Also the "DAYS
  569.        To Run" are all flagged (in the PCBEvent.dat), as the 1st of every
  570.        month does _NOT_ always fall on a Monday or a Friday.
  571.  
  572.         3) You may have the following differences in your PCBEvent.dat and
  573.            PCBEvent.hst:
  574.  
  575.            1) Suspend Time
  576.            2) Slide Event If A User Is On-Line.
  577.            3) Disallow Uploads Prior To The Event
  578.            4) Disallow Uploads Prior To The Event TIME
  579.            5) Naturally The Batch File To Run.
  580.  
  581.         If you have any problems setting up your "Once A Month" event
  582.       remember I do answer my electronic mail and my voice phone!
  583.  
  584.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 13
  585. -----------------------------------------------------------------------------
  586.  
  587.  
  588.  MENU SELECTIONS:
  589.  ===============
  590.  
  591.         The menu has 6 options.  Here is a brief description of each.
  592.  
  593.         1) Configure PCBEvent CHG File
  594.            Use to add/edit a nodes path.
  595.  
  596.         2) Node Event Editor
  597.            Use to add/edit/delete an event for a node.
  598.  
  599.         3) Update All Nodes
  600.            Use to update all nodes event times.
  601.            Sort and write all nodes PCBEvent.dat files.
  602.  
  603.         4) Update A Node
  604.            Use to update a node event time.
  605.            Sort and write a node PCBEvent.dat file.
  606.  
  607.         5) Status of ALL Nodes 
  608.            Use to see each nodes next event time, status and event batch
  609.            file.
  610.  
  611.         6) Toggle Sound Off / On
  612.            Use to turn the sound off or on.
  613.  
  614.         6) Exit PCBEvent Manager
  615.            Use to exit to DOS.
  616.  
  617.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 14
  618. -----------------------------------------------------------------------------
  619.  
  620.  FILES CREATED AND MODIFIED BY PCBEvent:
  621.  ======================================
  622.  
  623.     1) PCBoard.dat   - Updated with next event data. _DO NOT DELETE_ One in
  624.        each node(s) directory.
  625.  
  626.     2) PCBoard.da$   - Backup PCBoard.sys, _DO NOT DELETE_, this is used if
  627.        PCBEvent can not find your PCBoard.dat file.  One in node(s) each
  628.        directory.
  629.  
  630.     3) Event.sys     - Updated with next event data.  One in each node(s)
  631.        directory.
  632.  
  633.     4) Event.sy$     - Backup Event.sys, _DO NOT DELETE_, this is used if
  634.        PCBEvent can not find your Event.sys file.  One in each node(s)
  635.        directory.
  636.  
  637.     5) PCBEvent.dat  - Event data, sorted and written from menu operation
  638.        only.  One in each node(s) directory.
  639.  
  640.     6) PCBEvent.da$  - Backup PCBEvent.dat, _DO NOT DELETE_, this is used if
  641.        PCBEvent can not find your PCBEvent.dat file.  One in node(s) each
  642.        directory.
  643.  
  644.     7) PCBEvent.log  - Log of PCBEvent activities for Node(x). Source for
  645.        trouble shooting.  Delete after reviewing.  PCBEvent will not delete.
  646.        One in each node(s) directory.
  647.  
  648.     8) PCBEvent.cfg  - Stores PCBoard, Node, path, file information.  Also
  649.        stores some next event information for fast recall.  _DO NOT DELETE_
  650.        If Deleted you will have to re-configure.
  651.  
  652.     9) Node(X)       - A Null file made to signal other nodes that an event
  653.        is in progress on node X.  Made by WaitDownWS/WaitUpWS command switch.
  654.  
  655.    10) PCBEvent.err  - PCBEvent will create if it encounters an error One in
  656.        each node(s) directory.
  657.  
  658.  
  659. PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL          Page - 15
  660. --------------------------------------------------------------------------
  661.  
  662.  COMMENTS:
  663.  ========
  664.  
  665.         I hope you like this utility and that it saves you lots of headaches.
  666.      If you like it PLEASE let me know, and if you want to add to the wish
  667.      list, GREAT!  If you like it enough to use it then please Register it.
  668.      Each registration inspires and keeps this author at the key board.
  669.  
  670.         If you have any problems installing PCBEvent or any of my
  671.      utilities/doors, SUPPORT is available on Blue Light BBS.  Just (J)oin
  672.      conference #99 or feel free to call me voice ( 614-882-0994 ).
  673.  
  674.  
  675.      NOTE: First time callers to Blue Light BBS
  676.  
  677.         You will be required to complete INSTALED (question and answer door),
  678.      when completed you will be automatically placed into PCBVerify.  You may
  679.      abort the call back.  When you return to PCBoard you will be able to
  680.      (J)oin conference #99 - Daves-Place.
  681.  
  682.  
  683.      PLEASE, if you are having a problem upload to me a copy of:
  684.  
  685.                 1) PCBEvent.dat
  686.                 2) PCBEvent.log
  687.                 3) PCBEvent.err
  688.                 4) PCBEvent.cfg
  689.                 5) Autoexec.bat
  690.                 6) Board.bat
  691.                 7) Event.sys
  692.                 8) Anything else that may be of help.
  693.  
  694.         I monitor the DOOR and UTILITY conferences on Salt Air, and the Doors 
  695.      and PCBHints conferences on the Rime network.  Please address all
  696.      messages to David Casto.
  697.  
  698.  PCBEvent Version 2.5  - PCBEvent.DOC  -  USER MANUAL              Page - 16
  699. -----------------------------------------------------------------------------
  700.  
  701.  WHAT'S NEW WITH 2.5
  702.  ===================
  703.  
  704.    Fixed - PCBEvent would not recognize a new installation if you turned off
  705.     the sound before configuring.
  706.  
  707.    Fixed - Would exit if it ran into no events within the next 24 hours.
  708.  
  709.    Fixed - Would exit with an "Error 5" if a user placed one digit in a
  710.     minute field in the editor.
  711.  
  712.    Added - Messages to the user to help define input questions. Input errors
  713.     are now defined.
  714.  
  715.    Added - Up Arrow, Down Arrow, ESC and F10 keys to the editor.  Up Arrow
  716.     will advance the input to the prior field.  Down Arrow will advance input
  717.     to the next field.  ESC will exit the editor and return to the Main Menu
  718.     without saving changes.  F10 will save any changes.
  719.  
  720. *  Added - I have included a utility to set PCBEvent.exe file attribute to 
  721.     read only.  This should clear up some reports of PCBEvent locking up 
  722.     while multiple nodes run PCBEvent at the same time. It will change 
  723.     PCBEvent.exe to read only if it is not currently set to read only.  It 
  724.     will also remove the read only attribute if it is currently set to read 
  725.     only. PCBEvent Attribute Utility (PCBEAU.EXE) MUST be executed in the 
  726.     same directory as PCBEvent.exe.
  727.  
  728.  PCBEvent Version 2.5  - PCBEvent.DOC  -  USER MANUAL              Page - 17
  729. -----------------------------------------------------------------------------
  730.  
  731.  WHAT WAS NEW WITH 2.4:
  732.  =====================
  733.  
  734.    Added - New data input routines to the editor.  When you edit an existing
  735.     record the fields will have the previous value.  This will save a lot
  736.     of needless typing.
  737.  
  738.    Added - Toggle Sound Off / On option to the Main Menu.  This option will
  739.     allow you turn off ALL sound.
  740.  
  741.    Fixed - Cosmetic changes to the Node Editor.
  742.     
  743.    Fixed - Node Event Status display.  It would list 12 nodes (one window)
  744.     and no more.
  745.  
  746.    Tested - Due to conflicts with some software and OS2's "DOS" windows, I
  747.     tested PCBEvent in this environment and it passed.
  748.  
  749.  
  750.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 18
  751. -----------------------------------------------------------------------------
  752.  
  753.  WHAT WAS NEW WITH 2.3:
  754.  =====================
  755.  
  756. *  Added - Demo key ability.  A demo key is included with PCBEvent 2.5. This
  757.     demo key will allow you to use the software as if it were registered.
  758.     The key will work for 30 days from the date PCBEvent was compiled.
  759.  
  760.    Added - /WaitDownWS:Y:X:xxx switch.  This option is for systems that are
  761.     running a LAN and have the PCBoard node directories on workstations
  762.     and PCBEvent on the server.  This option _must_ be used with WaitUpWS.
  763.     The SET PCBEVENT environment path must be available to each
  764.     workstation.  Node Y will wait for node X to exit PCBoard and run it's
  765.     event.  It will wait xxx seconds before it will exit.  If node X has
  766.     dropped to the event before the xxx seconds an errorlevel of 0 will be
  767.     returned.  If node X does not drop within the xxx seconds an
  768.     errorlevel of 10 will be returned.  See example Event2.bat.
  769.  
  770.    Added - /WaitUpWS:Y:X:xxx switch.  This option is for systems that are
  771.     running a LAN and have the PCBoard node directories on workstations
  772.     and PCBEvent on the server.  This option _must_ be used with
  773.     WaitDownWS.  The SET PCBEVENT environment path must be available to
  774.     each workstation.  Node Y will wait for node X to return to PCBoard.
  775.     It will wait xxx seconds before it will exit.  If node X has returned
  776.     to PCBoard before the xxx seconds an errorlevel of 0 will be returned.
  777.     If node X does not return to PCBoard within the xxx seconds an
  778.     errorlevel of 10 will be returned.  See example Event1.bat.
  779.  
  780.    Added - Retry when accessing LOCKED files.  Will now try 20 times to
  781.     access a locked file before aborting.
  782.  
  783.   Improved - File access error routines and logging.
  784.  
  785.  PCBEvent Version 2.5  -  PCBEvent.DOC  -  USER MANUAL              Page - 19
  786. -----------------------------------------------------------------------------
  787.  
  788.  FILES INCLUDED WITH PCBEvent v2.5 :
  789.  =================================
  790.  
  791.        1)  PCBEvent.HST - Example Once A Month Data File
  792.        2)  PCBEvent.DAT - Example Event Data File
  793.        3)  PCBEvent.DOC - Your Reading It!
  794.        4)  PCBEvent.ERR - Example Error Log
  795.        5)  PCBEvent.EXE - PCBEvent Executable
  796.        6)  PCBEvent.LOG - Example PCBEvent Activity Log
  797.        7)  PCBEvent.REG - PCBEvent Registration Form
  798.        8)  PCBEvent.NEW - PCBEvent What's New With v2.5
  799.        9)  Caller1      - Example Caller Log
  800.       10)  Event1.bat   - Example Event Batch File
  801.       11)  Event2.bat   - Example Event Batch File (WaitDownWS WaitUpWS)
  802.       12)  Event.sys    - Example Of PCBEvent's Event.sys Creation
  803.       13)  Monthly.bat  - Example Of A Monthly Event Batch File
  804.       14)  NewMonth.bat - Example Of A Monthly System Event Batch File
  805.       15)  File_id.diz  - Archive Description
  806.       16)  Lockdor1.zip - LockDoor Program For Registered PCBEvent Owners
  807.       17)  Blueligh.inf - Information For Access To The Support BBS
  808.       18)  PCBEAU.EXE   - Set PCBEvent.exe Read Only Attribute On/Off
  809.       19)  PCBEAU.DOC   - PCBEAU DOC File.
  810.  
  811.